home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / DiceSource / doc / alib.doc < prev    next >
Text File  |  1993-07-05  |  7KB  |  293 lines
  1.  
  2.     ALIB.DOC (c)Copyright 1990, Matthew Dillon, All Rights Reserved
  3.  
  4. TABLE OF CONTENTS
  5.  
  6. auto.lib/alib/doslib.a
  7. auto.lib/alib/gfxlib.a
  8. auto.lib/alib/ieeelib.a
  9. auto.lib/alib/ieeetranlib.a
  10. auto.lib/alib/intlib.a
  11. auto.lib/alib/mathlib.a
  12. auto.lib/alib/mathtranlib.a
  13.  
  14.  
  15. alib/doslib                        alib/doslib
  16.  
  17.    NAME
  18.     _DOSBase auto-open
  19.  
  20.    SYNOPSIS
  21.  
  22.    FUNCTION
  23.     If the _DOSBase base variable is referenced (i.e. extern) but not
  24.     declared then _DOSBase will be automatically declared in the doslib
  25.     module of auto.lib.  Additionally, auto.lib adds routines to the
  26.     autoinit and autoexit sequences called by c.a that automatically
  27.     opens "dos.library" before _main and closes it after _exit.
  28.  
  29.     If the auto-open fails the program will be aborted before _main is
  30.     ever called.
  31.  
  32.     The autoexit routine that closes the library first checks to see if
  33.     the base variable is NULL and skips trying to close the library if
  34.     so.
  35.  
  36.    NOTE
  37.     _DOSBase is normally openned this way for most programs since parts
  38.     of c.a are normally reference that make dos calls.  In fact, all
  39.     programs that use the main() entry point since c.lib's _main()
  40.     entry point references DOS.
  41.  
  42.    EXAMPLE
  43.  
  44.    SEE ALSO
  45.  
  46.  
  47. alib/gfxlib                        alib/gfxlib
  48.  
  49.    NAME
  50.     _GFXBase auto-open
  51.  
  52.    SYNOPSIS
  53.  
  54.    FUNCTION
  55.     If the _GFXBase base variable is referenced (i.e. extern) but not
  56.     declared then _GFXBase will be automatically declared in the gfxlib
  57.     module of auto.lib.  Additionally, auto.lib adds routines to the
  58.     autoinit and autoexit sequences called by c.a that automatically
  59.     opens "graphics.library" before _main and closes it after _exit.
  60.  
  61.     If the auto-open fails the program will be aborted before _main is
  62.     ever called.
  63.  
  64.     The autoexit routine that closes the library first checks to see if
  65.     the base variable is NULL and skips trying to close the library if
  66.     so.
  67.  
  68.    NOTE
  69.     Programs that use this auto-open feature by simply calling graphics
  70.     library functions without bothering to declare or open the library
  71.     will only compile under DICE.  When compiled with other compilers a
  72.     link error will occur since the linker will not be able to find any
  73.     declared storage for the base variable, only references.
  74.  
  75.    EXAMPLE
  76.     /*
  77.      *  Example program which just calls a graphics.library function
  78.      *  without bothering to open the library.
  79.      */
  80.  
  81.     main()
  82.     {
  83.         WaitTOF();
  84.     }
  85.  
  86.    SEE ALSO
  87.  
  88.  
  89. alib/ieeelib                        alib/ieeelib
  90.  
  91.    NAME
  92.     _MathIeeeDoubBasBase auto-open
  93.  
  94.    SYNOPSIS
  95.  
  96.    FUNCTION
  97.     If the _MathIeeeDoubBasBase base variable is referenced (i.e.
  98.     extern) but not declared then _MathIeeeDoubBasBase will be
  99.     automatically declared in the ieeelib module of auto.lib.
  100.     Additionally, auto.lib adds routines to the autoinit and autoexit
  101.     sequences called by c.a that automatically opens
  102.     "mathieeedoubbas.library" before _main and closes it after _exit.
  103.  
  104.     If the auto-open fails the program will be aborted before _main is
  105.     ever called.
  106.  
  107.     The autoexit routine that closes the library first checks to see if
  108.     the base variable is NULL and skips trying to close the library if
  109.     so.
  110.  
  111.    NOTE
  112.     DICE uses the autoinit feature to automatically open and close
  113.     floating point libraries that are indirectly referenced by
  114.     fp operations.
  115.  
  116.    EXAMPLE
  117.     #include <stdlib.h>
  118.  
  119.     main()
  120.     {
  121.         double d;
  122.  
  123.         d = atof("1.234");
  124.     }
  125.  
  126.    SEE ALSO
  127.  
  128.  
  129. alib/ieeetranlib                    alib/ieeetranlib
  130.  
  131.    NAME
  132.     _MathIeeeDoubTransBase auto-open
  133.  
  134.    SYNOPSIS
  135.  
  136.    FUNCTION
  137.     If the _MathIeeeDoubTransBase base variable is referenced (i.e.
  138.     extern) but not declared then _MathIeeeDoubTransBase will be
  139.     automatically declared in the ieeetranlib module of auto.lib.
  140.     Additionally, auto.lib adds routines to the autoinit and autoexit
  141.     sequences called by c.a that automatically opens
  142.     "mathieeedoubtrans.library" before _main and closes it after _exit.
  143.  
  144.     If the auto-open fails the program will be aborted before _main is
  145.     ever called.
  146.  
  147.     The autoexit routine that closes the library first checks to see if
  148.     the base variable is NULL and skips trying to close the library if
  149.     so.
  150.  
  151.    NOTE
  152.     DICE uses the autoinit feature to automatically open and close
  153.     floating point libraries that are indirectly referenced by
  154.     fp operations.
  155.  
  156.    EXAMPLE
  157.     #include <stdlib.h>
  158.  
  159.     main()
  160.     {
  161.         double d;
  162.  
  163.         d = atof("1.234");
  164.     }
  165.  
  166.    SEE ALSO
  167.  
  168.  
  169. alib/intlib                        alib/intlib
  170.  
  171.    NAME
  172.     _IntuitionBase auto-open
  173.  
  174.    SYNOPSIS
  175.  
  176.    FUNCTION
  177.     If the _IntuitionBase base variable is referenced (i.e. extern) but
  178.     not declared then _IntuitionBase will be automatically declared in
  179.     the intlib module of auto.lib. Additionally, auto.lib adds routines
  180.     to the autoinit and autoexit sequences called by c.a that
  181.     automatically opens "intuition.library" before _main and
  182.     closes it after _exit.
  183.  
  184.     If the auto-open fails the program will be aborted before _main is
  185.     ever called.
  186.  
  187.     The autoexit routine that closes the library first checks to see if
  188.     the base variable is NULL and skips trying to close the library if
  189.     so.
  190.  
  191.    NOTE
  192.     Programs that use this auto-open feature by simply calling graphics
  193.     library functions without bothering to declare or open the library
  194.     will only compile under DICE.  When compiled with other compilers a
  195.     link error will occur since the linker will not be able to find any
  196.     declared storage for the base variable, only references.
  197.  
  198.    EXAMPLE
  199.     /*
  200.      *  Example program which just calls an intuition.library function
  201.      *  without bothering to open the library.
  202.      */
  203.  
  204.     main()
  205.     {
  206.         LockIBase();
  207.         UnlockIBase();
  208.     }
  209.  
  210.    SEE ALSO
  211.  
  212.  
  213. alib/mathlib                        alib/mathlib
  214.  
  215.    NAME
  216.     _MathBase auto-open
  217.  
  218.    SYNOPSIS
  219.  
  220.    FUNCTION
  221.     If the _MathBase base variable is referenced (i.e. extern) but not
  222.     declared then _MathBase will be automatically declared in the
  223.     mathlib module of auto.lib. Additionally, auto.lib adds routines to
  224.     the autoinit and autoexit sequences called by c.a that
  225.     automatically opens "math.library" before _main and closes it after
  226.     _exit.
  227.  
  228.     If the auto-open fails the program will be aborted before _main is
  229.     ever called.
  230.  
  231.     The autoexit routine that closes the library first checks to see if
  232.     the base variable is NULL and skips trying to close the library if
  233.     so.
  234.  
  235.    NOTE
  236.     DICE uses the autoinit feature to automatically open and close
  237.     floating point libraries that are indirectly referenced by
  238.     fp operations.
  239.  
  240.    EXAMPLE
  241.     #include <stdlib.h>
  242.  
  243.     main()
  244.     {
  245.         float f;
  246.  
  247.         f = atof("1.234");
  248.     }
  249.  
  250.    SEE ALSO
  251.  
  252.  
  253. alib/mathtranlib                    alib/mathtranlib
  254.  
  255.    NAME
  256.     _MathTransBase auto-open
  257.  
  258.    SYNOPSIS
  259.  
  260.    FUNCTION
  261.     If the _MathTransBase base variable is referenced (i.e. extern) but
  262.     not declared then _MathTransBase will be automatically declared in
  263.     the mathlib module of auto.lib. Additionally, auto.lib adds
  264.     routines to the autoinit and autoexit sequences called by c.a that
  265.     automatically opens "mathtrans.library" before _main and closes it after
  266.     _exit.
  267.  
  268.     If the auto-open fails the program will be aborted before _main is
  269.     ever called.
  270.  
  271.     The autoexit routine that closes the library first checks to see if
  272.     the base variable is NULL and skips trying to close the library if
  273.     so.
  274.  
  275.    NOTE
  276.     DICE uses the autoinit feature to automatically open and close
  277.     floating point libraries that are indirectly referenced by
  278.     fp operations.
  279.  
  280.    EXAMPLE
  281.     #include <stdlib.h>
  282.     #include <math.h>
  283.  
  284.     main()
  285.     {
  286.         float f;
  287.  
  288.         f = flog(10.0);
  289.     }
  290.  
  291.    SEE ALSO
  292.  
  293.